<!DOCTYPE html>
<html lang="en-US">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<meta http-equiv="X-UA-Compatible" content="IE=edge">
<title>gen_arbitrary_distortion_map [HALCON算子参考手册]</title>
<style type="text/css">
      body {
    color: #000000;
    background-color: #ffffff;
    margin: 0;
    font-family: Arial, Helvetica, sans-serif;
}

.body_main {
    margin-left: 35px;
    margin-right: 35px;
}

@media screen and (min-width:992px) {

    .body_main {
        margin-left: 10%;
        margin-right: 10%;
    }

    table.toctable {
        width: 80%
    }
}

@media screen and (min-width:1400px) {

    .body_main {
        margin-left: 15%;
        margin-right: 15%;
    }

    table.toctable {
        width: 70%
    }
}

body>div ul ul {
    margin-left: inherit;
}

a:link {
    color: #0044cc;
}

a:link,
a:visited {
    text-decoration: none;
}

a:link:hover,
a:visited:hover {
    text-decoration: underline;
}

th {
    text-align: left;
}

h1,
h2,
h3,
h4,
h5,
h6 {
    text-rendering: optimizeLegibility;
    color: #666666;
}

code {
    font-family: monospace,monospace;
}

h1 a.halconoperator {
    font-family: Arial, Helvetica, sans-serif;
    color: #666666;
}

h2 a.halconoperator {
    font-family: Arial, Helvetica, sans-serif;
    color: #666666;
}

hr {
    border: 0;
    border-top: solid 1px #f28d26;
}

.pre {
    display: block;
    padding-bottom: 1ex;
    font-family: monospace;
    white-space: pre;
}

pre {
    font-family: monospace, monospace;
    padding: 1ex;
    white-space: pre-wrap;
}

.toc {
    font-size: 80%;
    border-top: 1px dashed #f28d26;
    border-bottom: 1px dashed #f28d26;
    padding-top: 5px;
    padding-bottom: 5px;
}

.inv {
    margin: 0;
    border: 0;
    padding: 0;
}

.banner {
    color: #666666;
    padding-left: 1em;
}

.logo {
    background-color: white;
}

.keyboard {
    font-size: 80%;
    padding-left: 3px;
    padding-right: 3px;
    border-radius: 5px;
    border-width: 1px;
    border-style: solid;
    border-color: #f28d26;
    background-color: #f3f3f3;
}

.warning {
    margin-top: 2ex;
    margin-bottom: 1ex;
    padding: 10px;
    text-align: center;
    border: 1px solid;
    color: #bb0000;
    background-color: #fff7f7
}

.imprint {
    margin-top: 1ex;
    font-size: 80%;
    color: #666666;
}

.imprinthead {
    font-weight: bolder;
    color: #666666;
}

.indexlink {
    text-align: right;
    padding-bottom: 5px;
}

.postscript {
    margin-top: 2ex;
    font-size: 80%;
    color: #666666
}

.evenrow {
    background-color: #e7e7ef;
    vertical-align: top;
}

.oddrow {
    background-color: #f7f7ff;
    vertical-align: top;
}

.headrow {
    background-color: #97979f;
    color: #ffffff;
    vertical-align: top;
}

.logorow {
    vertical-align: top;
}

.error {
    color: red;
}

.var {
    font-style: italic
}

.halconoperator {
    font-family: monospace, monospace;
}

span.operator {
    font-family: monospace, monospace;
}

span.procedure {
    font-family: monospace, monospace;
}

span.operation {
    font-family: monospace, monospace;
}

span.feature {
    font-family: Arial, Helvetica, Homerton, sans-serif;
}

ul {
    padding-left: 1.2em;
}

li.dot {
    list-style-type: square;
    color: #f28d26;
}

.breadcrumb {
    font-size: 80%;
    color: white;
    background-color: #062d64;
    margin-bottom: 20px;
    padding-left: 35px;
    padding-right: 35px;
    padding-bottom: 15px;
}

.webbar {
    font-size: 80%;
    background-color: #dddddd;
    margin-top: 0px;
    margin-left: -35px;
    margin-right: -35px;
    margin-bottom: 0px;
    padding-top: 5px;
    padding-left: 35px;
    padding-right: 35px;
    padding-bottom: 5px;
}

.footer {
    display: flex;
    flex-wrap: wrap;
    justify-content: space-between;
    border-top: 1px dashed #f28d26;
    font-size: 80%;
    color: #666666;
    padding-bottom: 8px;
}

.footer .socialmedia a {
    padding-left: 7px;
}

.socialmedia {
    padding-top: 10px;
}

.copyright {
    margin-top: 19px;
}

.breadcrumb a {
    color: #ffffff;
    border-bottom: 1px solid white;
}

.breadcrumb a:link:hover,
.breadcrumb a:visited:hover {
    text-decoration: none;
    border-bottom: none;
}

.heading {
    margin-top: 1ex;
    font-size: 110%;
    font-weight: bold;
    color: #666666;
}

.text {
    color: black;
}

.example {
    font-size: 80%;
    background-color: #f3f3f3;
    border: 1px dashed #666666;
    padding: 10px;
}

.displaymath {
    display: block;
    text-align: center;
    margin-top: 1ex;
    margin-bottom: 1ex;
}

.title {
    float: left;
    padding-top: 3px;
    padding-bottom: 3px;
}

.signnote {
    font-family: Arial, Helvetica, Homerton, sans-serif;
    font-size: 80%;
    color: #666666;
    font-weight: lighter;
    font-style: italic
}

.par {
    margin-bottom: 1.5em;
}

.parhead {
    text-align: right;
}

.parname {
    float: left;
}

.pardesc {
    font-size: 85%;
    margin-top: 0.5em;
    margin-bottom: 0.5em;
    margin-left: 2em;
}

.parcat {
    color: #666;
    font-weight: bold;
}

*[data-if=cpp],
*[data-if=c],
*[data-if=dotnet],
*[data-if=com],
*[data-if=python] {
    display: none;
}

.tabbar {
    text-align: right;
    border-bottom: 1px solid #f28d26;
    margin-bottom: 0.5em;
}

ul.tabs {
    padding-top: 3px;
    padding-bottom: 3px;
    margin-top: 10px;
    margin-bottom: 0;
    font-size: 80%
}

ul.tabs li {
    padding-top: 3px;
    padding-bottom: 3px;
    display: inline;
    overflow: hidden;
    list-style-type: none;
    margin: 0;
    margin-left: 8px;
    border-top: 1px solid #666;
    border-left: 1px solid #666;
    border-right: 1px solid #666;
}

ul.tabs li.active {
    border-left: 1px solid #f28d26;
    border-right: 1px solid #f28d26;
    border-top: 1px solid #f28d26;
    border-bottom: 1px solid #fff;
}

ul.tabs li.inactive {
    background-color: #eee;
}

ul.tabs li a {
    padding-left: 5px;
    padding-right: 5px;
    color: #666;
}

ul.tabs li a:link:hover {
    text-decoration: none;
}

ul.tabs li.inactive a {
    color: #666;
}

ul.tabs li.active a {
    color: black;
}

dl.generic dd {
    margin-bottom: 1em;
}

.pari {
    color: olive;
}

.paro {
    color: maroon;
}

.comment {
    font-size: 80%;
    color: green;
    white-space: nowrap;
}

table.grid {
    border-collapse: collapse;
}

table.grid td {
    padding: 5px;
    border: 1px solid;
}

table.layout {
    border: 0px;
}

table.layout td {
    padding: 5px;
}

table.table {
    border-collapse: collapse;
}

table.table td {
    padding: 5px;
    border-left: 0px;
    border-right: 0px;
}

table.table tr:last-child {
    border-bottom: 1px solid;
}

table.table th {
    padding: 5px;
    border-top: 1px solid;
    border-bottom: 1px solid;
    border-left: 0px;
    border-right: 0px;
}

.details_summary {
    cursor: pointer;
}

table.toctable {
    width: 100%;
}

table.toctable col:first-child {
    width: 20%;
}

table.toctable col:nth-last-child(2) {
    width: 8%;
}

table.altcolored tr:nth-child(even) {
    background-color: #f3f3f3;
}

    </style>
<!--OP_REF_STYLE_END-->
<script>
    <!--
var active_lang='hdevelop';function switchVisibility(obj,active_lang,new_lang)
{var display_style='inline';
for(var i=0;i<obj.length;i++)
{if(obj.item(i).getAttribute('data-if')==new_lang)
{obj.item(i).style.display=display_style;}
if(obj.item(i).getAttribute('data-if')==active_lang)
{obj.item(i).style.display='none';}}
return;}
function toggleLanguage(new_lang,initial)
{if(active_lang!=new_lang)
{var lis=document.getElementsByTagName('li');for(var i=0;i<lis.length;i++)
{if(lis.item(i).id=='syn-'+new_lang)
{lis.item(i).className='active';}
else
{lis.item(i).className='inactive';}}
var divs=document.getElementsByTagName('div');var spans=document.getElementsByTagName('span');switchVisibility(divs,active_lang,new_lang);switchVisibility(spans,active_lang,new_lang);if(!initial)
{setCookie("halcon_reference_language",new_lang,null,null);}
active_lang=new_lang;}
return;}
function setCookie(name,value,domain,exp_offset,path,secure)
{localStorage.setItem(name,value);}
function getCookie(name)
{return localStorage.getItem(name);}
function initialize()
{var qs=location.href.split('?')[1];var qs_lang_raw=location.href.split('interface=')[1];var qs_lang;if(qs_lang_raw)
{qs_lang=qs_lang_raw.split('#')[0];}
var cookie_lang=getCookie("halcon_reference_language");var new_lang;if((qs_lang=="hdevelop")||(qs_lang=="dotnet")||(qs_lang=="python")||(qs_lang=="cpp")||(qs_lang=="c"))
{new_lang=qs_lang;setCookie("halcon_reference_language",new_lang,null,null);}
else if((cookie_lang=="hdevelop")||(cookie_lang=="dotnet")||(cookie_lang=="python")||(cookie_lang=="cpp")||(cookie_lang=="c"))
{new_lang=cookie_lang;}
else
{new_lang="hdevelop";}
toggleLanguage(new_lang,1);return;}
-->

  </script>
</head>
<body onload="initialize();">
<div class="breadcrumb">
<br class="inv"><a href="index.html">目录</a> / <a href="toc_tools.html">工具</a> / <a href="toc_tools_gridrectification.html">Grid Rectification</a><br class="inv">
</div>
<div class="body_main">
<div class="tabbar"><ul class="tabs">
<li id="syn-hdevelop" class="active"><a href="javascript:void(0);" onclick="toggleLanguage('hdevelop')" onfocus="blur()">HDevelop</a></li>
<li id="syn-dotnet" class="inactive"><a href="javascript:void(0);" onclick="toggleLanguage('dotnet')" onfocus="blur()">.NET</a></li>
<li id="syn-python" class="inactive"><a href="javascript:void(0);" onclick="toggleLanguage('python')" onfocus="blur()">Python</a></li>
<li id="syn-cpp" class="inactive"><a href="javascript:void(0);" onclick="toggleLanguage('cpp')" onfocus="blur()">C++</a></li>
<li id="syn-c" class="inactive"><a href="javascript:void(0);" onclick="toggleLanguage('c')" onfocus="blur()">C</a></li>
</ul></div>
<div class="indexlink">
<a href="index_classes.html"><span data-if="dotnet" style="display:none;">类别</span><span data-if="cpp" style="display:none;">类别</span></a><span data-if="dotnet" style="display:none;"> | </span><span data-if="cpp" style="display:none;"> | </span><a href="index_by_name.html">算子列表</a>
</div>
<!--OP_REF_HEADER_END-->
<h1 id="sec_name">
<span data-if="hdevelop" style="display:inline;">gen_arbitrary_distortion_map</span><span data-if="c" style="display:none;">T_gen_arbitrary_distortion_map</span><span data-if="cpp" style="display:none;">GenArbitraryDistortionMap</span><span data-if="dotnet" style="display:none;">GenArbitraryDistortionMap</span><span data-if="python" style="display:none;">gen_arbitrary_distortion_map</span> (算子名称)</h1>
<h2>名称</h2>
<p><code><span data-if="hdevelop" style="display:inline;">gen_arbitrary_distortion_map</span><span data-if="c" style="display:none;">T_gen_arbitrary_distortion_map</span><span data-if="cpp" style="display:none;">GenArbitraryDistortionMap</span><span data-if="dotnet" style="display:none;">GenArbitraryDistortionMap</span><span data-if="python" style="display:none;">gen_arbitrary_distortion_map</span></code> — Generate a projection map that describes the mapping between an arbitrarily
distorted image and the rectified image.</p>
<h2 id="sec_synopsis">参数签名</h2>
<div data-if="hdevelop" style="display:inline;">
<p>
<code><b>gen_arbitrary_distortion_map</b>( : <a href="#Map"><i>Map</i></a> : <a href="#GridSpacing"><i>GridSpacing</i></a>, <a href="#Row"><i>Row</i></a>, <a href="#Column"><i>Column</i></a>, <a href="#GridWidth"><i>GridWidth</i></a>, <a href="#ImageWidth"><i>ImageWidth</i></a>, <a href="#ImageHeight"><i>ImageHeight</i></a>, <a href="#MapType"><i>MapType</i></a> : )</code></p>
</div>
<div data-if="c" style="display:none;">
<p>
<code>Herror <b>T_gen_arbitrary_distortion_map</b>(Hobject* <a href="#Map"><i>Map</i></a>, const Htuple <a href="#GridSpacing"><i>GridSpacing</i></a>, const Htuple <a href="#Row"><i>Row</i></a>, const Htuple <a href="#Column"><i>Column</i></a>, const Htuple <a href="#GridWidth"><i>GridWidth</i></a>, const Htuple <a href="#ImageWidth"><i>ImageWidth</i></a>, const Htuple <a href="#ImageHeight"><i>ImageHeight</i></a>, const Htuple <a href="#MapType"><i>MapType</i></a>)</code></p>
</div>
<div data-if="cpp" style="display:none;">
<p>
<code>void <b>GenArbitraryDistortionMap</b>(HObject* <a href="#Map"><i>Map</i></a>, const HTuple&amp; <a href="#GridSpacing"><i>GridSpacing</i></a>, const HTuple&amp; <a href="#Row"><i>Row</i></a>, const HTuple&amp; <a href="#Column"><i>Column</i></a>, const HTuple&amp; <a href="#GridWidth"><i>GridWidth</i></a>, const HTuple&amp; <a href="#ImageWidth"><i>ImageWidth</i></a>, const HTuple&amp; <a href="#ImageHeight"><i>ImageHeight</i></a>, const HTuple&amp; <a href="#MapType"><i>MapType</i></a>)</code></p>
<p>
<code>static <a href="HImage.html">HImage</a> <a href="HMisc.html">HMisc</a>::<b>GenArbitraryDistortionMap</b>(Hlong <a href="#GridSpacing"><i>GridSpacing</i></a>, const HTuple&amp; <a href="#Row"><i>Row</i></a>, const HTuple&amp; <a href="#Column"><i>Column</i></a>, Hlong <a href="#GridWidth"><i>GridWidth</i></a>, Hlong <a href="#ImageWidth"><i>ImageWidth</i></a>, Hlong <a href="#ImageHeight"><i>ImageHeight</i></a>, const HString&amp; <a href="#MapType"><i>MapType</i></a>)</code></p>
<p>
<code>static <a href="HImage.html">HImage</a> <a href="HMisc.html">HMisc</a>::<b>GenArbitraryDistortionMap</b>(Hlong <a href="#GridSpacing"><i>GridSpacing</i></a>, const HTuple&amp; <a href="#Row"><i>Row</i></a>, const HTuple&amp; <a href="#Column"><i>Column</i></a>, Hlong <a href="#GridWidth"><i>GridWidth</i></a>, Hlong <a href="#ImageWidth"><i>ImageWidth</i></a>, Hlong <a href="#ImageHeight"><i>ImageHeight</i></a>, const char* <a href="#MapType"><i>MapType</i></a>)</code></p>
<p>
<code>static <a href="HImage.html">HImage</a> <a href="HMisc.html">HMisc</a>::<b>GenArbitraryDistortionMap</b>(Hlong <a href="#GridSpacing"><i>GridSpacing</i></a>, const HTuple&amp; <a href="#Row"><i>Row</i></a>, const HTuple&amp; <a href="#Column"><i>Column</i></a>, Hlong <a href="#GridWidth"><i>GridWidth</i></a>, Hlong <a href="#ImageWidth"><i>ImageWidth</i></a>, Hlong <a href="#ImageHeight"><i>ImageHeight</i></a>, const wchar_t* <a href="#MapType"><i>MapType</i></a>)  <span class="signnote">
            (
            Windows only)
          </span></code></p>
</div>
<div data-if="com" style="display:none;"></div>
<div data-if="dotnet" style="display:none;">
<p>
<code>static void <a href="HOperatorSet.html">HOperatorSet</a>.<b>GenArbitraryDistortionMap</b>(out <a href="HObject.html">HObject</a> <a href="#Map"><i>map</i></a>, <a href="HTuple.html">HTuple</a> <a href="#GridSpacing"><i>gridSpacing</i></a>, <a href="HTuple.html">HTuple</a> <a href="#Row"><i>row</i></a>, <a href="HTuple.html">HTuple</a> <a href="#Column"><i>column</i></a>, <a href="HTuple.html">HTuple</a> <a href="#GridWidth"><i>gridWidth</i></a>, <a href="HTuple.html">HTuple</a> <a href="#ImageWidth"><i>imageWidth</i></a>, <a href="HTuple.html">HTuple</a> <a href="#ImageHeight"><i>imageHeight</i></a>, <a href="HTuple.html">HTuple</a> <a href="#MapType"><i>mapType</i></a>)</code></p>
<p>
<code>static <a href="HImage.html">HImage</a> <a href="HMisc.html">HMisc</a>.<b>GenArbitraryDistortionMap</b>(int <a href="#GridSpacing"><i>gridSpacing</i></a>, <a href="HTuple.html">HTuple</a> <a href="#Row"><i>row</i></a>, <a href="HTuple.html">HTuple</a> <a href="#Column"><i>column</i></a>, int <a href="#GridWidth"><i>gridWidth</i></a>, int <a href="#ImageWidth"><i>imageWidth</i></a>, int <a href="#ImageHeight"><i>imageHeight</i></a>, string <a href="#MapType"><i>mapType</i></a>)</code></p>
</div>
<div data-if="python" style="display:none;">
<p>
<code>def <b>gen_arbitrary_distortion_map</b>(<a href="#GridSpacing"><i>grid_spacing</i></a>: int, <a href="#Row"><i>row</i></a>: Sequence[float], <a href="#Column"><i>column</i></a>: Sequence[float], <a href="#GridWidth"><i>grid_width</i></a>: int, <a href="#ImageWidth"><i>image_width</i></a>: int, <a href="#ImageHeight"><i>image_height</i></a>: int, <a href="#MapType"><i>map_type</i></a>: str) -&gt; HObject</code></p>
</div>
<h2 id="sec_description">描述</h2>
<p><code><span data-if="hdevelop" style="display:inline">gen_arbitrary_distortion_map</span><span data-if="c" style="display:none">gen_arbitrary_distortion_map</span><span data-if="cpp" style="display:none">GenArbitraryDistortionMap</span><span data-if="com" style="display:none">GenArbitraryDistortionMap</span><span data-if="dotnet" style="display:none">GenArbitraryDistortionMap</span><span data-if="python" style="display:none">gen_arbitrary_distortion_map</span></code> computes the mapping <a href="#Map"><i><code><span data-if="hdevelop" style="display:inline">Map</span><span data-if="c" style="display:none">Map</span><span data-if="cpp" style="display:none">Map</span><span data-if="com" style="display:none">Map</span><span data-if="dotnet" style="display:none">map</span><span data-if="python" style="display:none">map</span></code></i></a>
between an arbitrarily distorted image and the rectified image.
The coordinates <a href="#Row"><i><code><span data-if="hdevelop" style="display:inline">Row</span><span data-if="c" style="display:none">Row</span><span data-if="cpp" style="display:none">Row</span><span data-if="com" style="display:none">Row</span><span data-if="dotnet" style="display:none">row</span><span data-if="python" style="display:none">row</span></code></i></a> and <a href="#Column"><i><code><span data-if="hdevelop" style="display:inline">Column</span><span data-if="c" style="display:none">Column</span><span data-if="cpp" style="display:none">Column</span><span data-if="com" style="display:none">Column</span><span data-if="dotnet" style="display:none">column</span><span data-if="python" style="display:none">column</span></code></i></a> describe a distorted grid,
which will be mapped onto a regular grid in the rectified image.
The coordinates of the (distorted) grid points must be passed line by line
in <a href="#Row"><i><code><span data-if="hdevelop" style="display:inline">Row</span><span data-if="c" style="display:none">Row</span><span data-if="cpp" style="display:none">Row</span><span data-if="com" style="display:none">Row</span><span data-if="dotnet" style="display:none">row</span><span data-if="python" style="display:none">row</span></code></i></a> and <a href="#Column"><i><code><span data-if="hdevelop" style="display:inline">Column</span><span data-if="c" style="display:none">Column</span><span data-if="cpp" style="display:none">Column</span><span data-if="com" style="display:none">Column</span><span data-if="dotnet" style="display:none">column</span><span data-if="python" style="display:none">column</span></code></i></a>. <a href="#GridWidth"><i><code><span data-if="hdevelop" style="display:inline">GridWidth</span><span data-if="c" style="display:none">GridWidth</span><span data-if="cpp" style="display:none">GridWidth</span><span data-if="com" style="display:none">GridWidth</span><span data-if="dotnet" style="display:none">gridWidth</span><span data-if="python" style="display:none">grid_width</span></code></i></a> is the width of the
point grid in grid points. <a href="#GridSpacing"><i><code><span data-if="hdevelop" style="display:inline">GridSpacing</span><span data-if="c" style="display:none">GridSpacing</span><span data-if="cpp" style="display:none">GridSpacing</span><span data-if="com" style="display:none">GridSpacing</span><span data-if="dotnet" style="display:none">gridSpacing</span><span data-if="python" style="display:none">grid_spacing</span></code></i></a> is the distance between
two adjacent grid points in the rectified image. Because the grid points
are always mapped to the centers of their corresponding pixels a grid cell
requires (<a href="#GridSpacing"><i><code><span data-if="hdevelop" style="display:inline">GridSpacing</span><span data-if="c" style="display:none">GridSpacing</span><span data-if="cpp" style="display:none">GridSpacing</span><span data-if="com" style="display:none">GridSpacing</span><span data-if="dotnet" style="display:none">gridSpacing</span><span data-if="python" style="display:none">grid_spacing</span></code></i></a>+1) x (<a href="#GridSpacing"><i><code><span data-if="hdevelop" style="display:inline">GridSpacing</span><span data-if="c" style="display:none">GridSpacing</span><span data-if="cpp" style="display:none">GridSpacing</span><span data-if="com" style="display:none">GridSpacing</span><span data-if="dotnet" style="display:none">gridSpacing</span><span data-if="python" style="display:none">grid_spacing</span></code></i></a>+1) pixels in the
rectified image. Note however, that, of course, adjacent grid cells
overlap by one pixel.
</p>
<p>To compute the mapping <a href="#Map"><i><code><span data-if="hdevelop" style="display:inline">Map</span><span data-if="c" style="display:none">Map</span><span data-if="cpp" style="display:none">Map</span><span data-if="com" style="display:none">Map</span><span data-if="dotnet" style="display:none">map</span><span data-if="python" style="display:none">map</span></code></i></a>, additionally the width
<a href="#ImageWidth"><i><code><span data-if="hdevelop" style="display:inline">ImageWidth</span><span data-if="c" style="display:none">ImageWidth</span><span data-if="cpp" style="display:none">ImageWidth</span><span data-if="com" style="display:none">ImageWidth</span><span data-if="dotnet" style="display:none">imageWidth</span><span data-if="python" style="display:none">image_width</span></code></i></a> and height <a href="#ImageHeight"><i><code><span data-if="hdevelop" style="display:inline">ImageHeight</span><span data-if="c" style="display:none">ImageHeight</span><span data-if="cpp" style="display:none">ImageHeight</span><span data-if="com" style="display:none">ImageHeight</span><span data-if="dotnet" style="display:none">imageHeight</span><span data-if="python" style="display:none">image_height</span></code></i></a> of the images to be
rectified must be passed.
</p>
<p><a href="#MapType"><i><code><span data-if="hdevelop" style="display:inline">MapType</span><span data-if="c" style="display:none">MapType</span><span data-if="cpp" style="display:none">MapType</span><span data-if="com" style="display:none">MapType</span><span data-if="dotnet" style="display:none">mapType</span><span data-if="python" style="display:none">map_type</span></code></i></a> is used to specify the type of the output <a href="#Map"><i><code><span data-if="hdevelop" style="display:inline">Map</span><span data-if="c" style="display:none">Map</span><span data-if="cpp" style="display:none">Map</span><span data-if="com" style="display:none">Map</span><span data-if="dotnet" style="display:none">map</span><span data-if="python" style="display:none">map</span></code></i></a>.
If <i><span data-if="hdevelop" style="display:inline">'bilinear'</span><span data-if="c" style="display:none">"bilinear"</span><span data-if="cpp" style="display:none">"bilinear"</span><span data-if="com" style="display:none">"bilinear"</span><span data-if="dotnet" style="display:none">"bilinear"</span><span data-if="python" style="display:none">"bilinear"</span></i> interpolation
is chosen, <a href="#Map"><i><code><span data-if="hdevelop" style="display:inline">Map</span><span data-if="c" style="display:none">Map</span><span data-if="cpp" style="display:none">Map</span><span data-if="com" style="display:none">Map</span><span data-if="dotnet" style="display:none">map</span><span data-if="python" style="display:none">map</span></code></i></a> consists of one image containing five channels.
In the first channel for each pixel in the resulting image the linearized
coordinates of the pixel in the input image is stored that is in the upper
left position relative to the transformed coordinates.
The four other channels contain the  weights of the four neighboring pixels
of the transformed coordinates which are used for the bilinear interpolation,
in the following order:
</p>
<div style="text-align:center"><table style="margin-left:auto;margin-right:auto" class="grid">
<col span="1">
<col span="1">
<tr>
<td style="text-align:center">
2 </td>
<td style="text-align:center"> 3 </td>
</tr>
<tr>
<td style="text-align:center">
4 </td>
<td style="text-align:center"> 5
</td>
</tr>
</table></div>
<p>The second channel, for example, contains the weights of the pixels that
lie to the upper left relative to the transformed coordinates.
If <i><span data-if="hdevelop" style="display:inline">'coord_map_sub_pix'</span><span data-if="c" style="display:none">"coord_map_sub_pix"</span><span data-if="cpp" style="display:none">"coord_map_sub_pix"</span><span data-if="com" style="display:none">"coord_map_sub_pix"</span><span data-if="dotnet" style="display:none">"coord_map_sub_pix"</span><span data-if="python" style="display:none">"coord_map_sub_pix"</span></i> is chosen, <a href="#Map"><i><code><span data-if="hdevelop" style="display:inline">Map</span><span data-if="c" style="display:none">Map</span><span data-if="cpp" style="display:none">Map</span><span data-if="com" style="display:none">Map</span><span data-if="dotnet" style="display:none">map</span><span data-if="python" style="display:none">map</span></code></i></a> consists of
one vector field image, in which for each pixel of the resulting image
the subpixel precise coordinates in the input image are stored.
</p>
<p>As mentioned above, four adjacent pixels in the distorted image are required
to interpolate the gray value of one pixel in the mapped image. If at
least one of these pixels is located outside of the distorted image the
gray value can not be calculated. The domain of the resulting <a href="#Map"><i><code><span data-if="hdevelop" style="display:inline">Map</span><span data-if="c" style="display:none">Map</span><span data-if="cpp" style="display:none">Map</span><span data-if="com" style="display:none">Map</span><span data-if="dotnet" style="display:none">map</span><span data-if="python" style="display:none">map</span></code></i></a>
domain is reduced accordingly.
</p>
<p>In contrary to <a href="gen_grid_rectification_map.html"><code><span data-if="hdevelop" style="display:inline">gen_grid_rectification_map</span><span data-if="c" style="display:none">gen_grid_rectification_map</span><span data-if="cpp" style="display:none">GenGridRectificationMap</span><span data-if="com" style="display:none">GenGridRectificationMap</span><span data-if="dotnet" style="display:none">GenGridRectificationMap</span><span data-if="python" style="display:none">gen_grid_rectification_map</span></code></a>,
<code><span data-if="hdevelop" style="display:inline">gen_arbitrary_distortion_map</span><span data-if="c" style="display:none">gen_arbitrary_distortion_map</span><span data-if="cpp" style="display:none">GenArbitraryDistortionMap</span><span data-if="com" style="display:none">GenArbitraryDistortionMap</span><span data-if="dotnet" style="display:none">GenArbitraryDistortionMap</span><span data-if="python" style="display:none">gen_arbitrary_distortion_map</span></code> is used when the coordinates
(<a href="#Row"><i><code><span data-if="hdevelop" style="display:inline">Row</span><span data-if="c" style="display:none">Row</span><span data-if="cpp" style="display:none">Row</span><span data-if="com" style="display:none">Row</span><span data-if="dotnet" style="display:none">row</span><span data-if="python" style="display:none">row</span></code></i></a>,<a href="#Column"><i><code><span data-if="hdevelop" style="display:inline">Column</span><span data-if="c" style="display:none">Column</span><span data-if="cpp" style="display:none">Column</span><span data-if="com" style="display:none">Column</span><span data-if="dotnet" style="display:none">column</span><span data-if="python" style="display:none">column</span></code></i></a>) of the grid points in the distorted image are
already known or the relevant part of the image consist of regular grid
structures, which the coordinates can be derived from.
</p>
<p>If you want to re-use the created map in another program, you can save it as
a multi-channel image with 该算子 <a href="write_image.html"><code><span data-if="hdevelop" style="display:inline">write_image</span><span data-if="c" style="display:none">write_image</span><span data-if="cpp" style="display:none">WriteImage</span><span data-if="com" style="display:none">WriteImage</span><span data-if="dotnet" style="display:none">WriteImage</span><span data-if="python" style="display:none">write_image</span></code></a>, using the format
<i><span data-if="hdevelop" style="display:inline">'tiff'</span><span data-if="c" style="display:none">"tiff"</span><span data-if="cpp" style="display:none">"tiff"</span><span data-if="com" style="display:none">"tiff"</span><span data-if="dotnet" style="display:none">"tiff"</span><span data-if="python" style="display:none">"tiff"</span></i>.</p>
<h2 id="sec_execution">运行信息</h2>
<ul>
  <li>多线程类型:可重入(与非独占操作符并行运行)。</li>
<li>多线程作用域:全局(可以从任何线程调用)。</li>
  <li>未经并行化处理。</li>
</ul>
<h2 id="sec_parameters">参数表</h2>
  <div class="par">
<div class="parhead">
<span id="Map" class="parname"><b><code><span data-if="hdevelop" style="display:inline">Map</span><span data-if="c" style="display:none">Map</span><span data-if="cpp" style="display:none">Map</span><span data-if="com" style="display:none">Map</span><span data-if="dotnet" style="display:none">map</span><span data-if="python" style="display:none">map</span></code></b> (output_object)  </span><span>multichannel-image <code>→</code> <span data-if="hdevelop" style="display:inline">object</span><span data-if="dotnet" style="display:none"><a href="HImage.html">HImage</a></span><span data-if="python" style="display:none">HObject</span><span data-if="cpp" style="display:none"><a href="HImage.html">HImage</a></span><span data-if="c" style="display:none">Hobject *</span> (int4 / uint2 / vector_field)</span>
</div>
<p class="pardesc">Image containing the mapping data.</p>
</div>
  <div class="par">
<div class="parhead">
<span id="GridSpacing" class="parname"><b><code><span data-if="hdevelop" style="display:inline">GridSpacing</span><span data-if="c" style="display:none">GridSpacing</span><span data-if="cpp" style="display:none">GridSpacing</span><span data-if="com" style="display:none">GridSpacing</span><span data-if="dotnet" style="display:none">gridSpacing</span><span data-if="python" style="display:none">grid_spacing</span></code></b> (input_control)  </span><span>integer <code>→</code> <span data-if="dotnet" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="python" style="display:none">int</span><span data-if="cpp" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="c" style="display:none">Htuple</span><span data-if="hdevelop" style="display:inline"> (integer)</span><span data-if="dotnet" style="display:none"> (<i>int</i> / </span><span data-if="dotnet" style="display:none">long)</span><span data-if="cpp" style="display:none"> (<i>Hlong</i>)</span><span data-if="c" style="display:none"> (<i>Hlong</i>)</span></span>
</div>
<p class="pardesc">Distance of the grid points in the rectified
image.</p>
<p class="pardesc"><span class="parcat">Restriction:
      </span><code>GridSpacing &gt; 0</code></p>
</div>
  <div class="par">
<div class="parhead">
<span id="Row" class="parname"><b><code><span data-if="hdevelop" style="display:inline">Row</span><span data-if="c" style="display:none">Row</span><span data-if="cpp" style="display:none">Row</span><span data-if="com" style="display:none">Row</span><span data-if="dotnet" style="display:none">row</span><span data-if="python" style="display:none">row</span></code></b> (input_control)  </span><span>point.y-array <code>→</code> <span data-if="dotnet" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="python" style="display:none">Sequence[float]</span><span data-if="cpp" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="c" style="display:none">Htuple</span><span data-if="hdevelop" style="display:inline"> (real)</span><span data-if="dotnet" style="display:none"> (<i>double</i>)</span><span data-if="cpp" style="display:none"> (<i>double</i>)</span><span data-if="c" style="display:none"> (<i>double</i>)</span></span>
</div>
<p class="pardesc">Row coordinates of the grid points in the distorted
image.</p>
</div>
  <div class="par">
<div class="parhead">
<span id="Column" class="parname"><b><code><span data-if="hdevelop" style="display:inline">Column</span><span data-if="c" style="display:none">Column</span><span data-if="cpp" style="display:none">Column</span><span data-if="com" style="display:none">Column</span><span data-if="dotnet" style="display:none">column</span><span data-if="python" style="display:none">column</span></code></b> (input_control)  </span><span>point.x-array <code>→</code> <span data-if="dotnet" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="python" style="display:none">Sequence[float]</span><span data-if="cpp" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="c" style="display:none">Htuple</span><span data-if="hdevelop" style="display:inline"> (real)</span><span data-if="dotnet" style="display:none"> (<i>double</i>)</span><span data-if="cpp" style="display:none"> (<i>double</i>)</span><span data-if="c" style="display:none"> (<i>double</i>)</span></span>
</div>
<p class="pardesc">Column coordinates of the grid points in the distorted
image.</p>
<p class="pardesc"><span class="parcat">Restriction:
      </span><code>number(Row) == number(Column)</code></p>
</div>
  <div class="par">
<div class="parhead">
<span id="GridWidth" class="parname"><b><code><span data-if="hdevelop" style="display:inline">GridWidth</span><span data-if="c" style="display:none">GridWidth</span><span data-if="cpp" style="display:none">GridWidth</span><span data-if="com" style="display:none">GridWidth</span><span data-if="dotnet" style="display:none">gridWidth</span><span data-if="python" style="display:none">grid_width</span></code></b> (input_control)  </span><span>integer <code>→</code> <span data-if="dotnet" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="python" style="display:none">int</span><span data-if="cpp" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="c" style="display:none">Htuple</span><span data-if="hdevelop" style="display:inline"> (integer)</span><span data-if="dotnet" style="display:none"> (<i>int</i> / </span><span data-if="dotnet" style="display:none">long)</span><span data-if="cpp" style="display:none"> (<i>Hlong</i>)</span><span data-if="c" style="display:none"> (<i>Hlong</i>)</span></span>
</div>
<p class="pardesc">Width of the point grid (number of grid points).</p>
</div>
  <div class="par">
<div class="parhead">
<span id="ImageWidth" class="parname"><b><code><span data-if="hdevelop" style="display:inline">ImageWidth</span><span data-if="c" style="display:none">ImageWidth</span><span data-if="cpp" style="display:none">ImageWidth</span><span data-if="com" style="display:none">ImageWidth</span><span data-if="dotnet" style="display:none">imageWidth</span><span data-if="python" style="display:none">image_width</span></code></b> (input_control)  </span><span>extent.x <code>→</code> <span data-if="dotnet" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="python" style="display:none">int</span><span data-if="cpp" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="c" style="display:none">Htuple</span><span data-if="hdevelop" style="display:inline"> (integer)</span><span data-if="dotnet" style="display:none"> (<i>int</i> / </span><span data-if="dotnet" style="display:none">long)</span><span data-if="cpp" style="display:none"> (<i>Hlong</i>)</span><span data-if="c" style="display:none"> (<i>Hlong</i>)</span></span>
</div>
<p class="pardesc">Width of the images to be rectified.</p>
<p class="pardesc"><span class="parcat">Restriction:
      </span><code>ImageWidth &gt; 0</code></p>
</div>
  <div class="par">
<div class="parhead">
<span id="ImageHeight" class="parname"><b><code><span data-if="hdevelop" style="display:inline">ImageHeight</span><span data-if="c" style="display:none">ImageHeight</span><span data-if="cpp" style="display:none">ImageHeight</span><span data-if="com" style="display:none">ImageHeight</span><span data-if="dotnet" style="display:none">imageHeight</span><span data-if="python" style="display:none">image_height</span></code></b> (input_control)  </span><span>extent.y <code>→</code> <span data-if="dotnet" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="python" style="display:none">int</span><span data-if="cpp" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="c" style="display:none">Htuple</span><span data-if="hdevelop" style="display:inline"> (integer)</span><span data-if="dotnet" style="display:none"> (<i>int</i> / </span><span data-if="dotnet" style="display:none">long)</span><span data-if="cpp" style="display:none"> (<i>Hlong</i>)</span><span data-if="c" style="display:none"> (<i>Hlong</i>)</span></span>
</div>
<p class="pardesc">Height of the images to be rectified.</p>
<p class="pardesc"><span class="parcat">Restriction:
      </span><code>ImageHeight &gt; 0</code></p>
</div>
  <div class="par">
<div class="parhead">
<span id="MapType" class="parname"><b><code><span data-if="hdevelop" style="display:inline">MapType</span><span data-if="c" style="display:none">MapType</span><span data-if="cpp" style="display:none">MapType</span><span data-if="com" style="display:none">MapType</span><span data-if="dotnet" style="display:none">mapType</span><span data-if="python" style="display:none">map_type</span></code></b> (input_control)  </span><span>string <code>→</code> <span data-if="dotnet" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="python" style="display:none">str</span><span data-if="cpp" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="c" style="display:none">Htuple</span><span data-if="hdevelop" style="display:inline"> (string)</span><span data-if="dotnet" style="display:none"> (<i>string</i>)</span><span data-if="cpp" style="display:none"> (<i>HString</i>)</span><span data-if="c" style="display:none"> (<i>char*</i>)</span></span>
</div>
<p class="pardesc">Type of mapping.</p>
<p class="pardesc"><span class="parcat">Default:
      </span>
    <span data-if="hdevelop" style="display:inline">'bilinear'</span>
    <span data-if="c" style="display:none">"bilinear"</span>
    <span data-if="cpp" style="display:none">"bilinear"</span>
    <span data-if="com" style="display:none">"bilinear"</span>
    <span data-if="dotnet" style="display:none">"bilinear"</span>
    <span data-if="python" style="display:none">"bilinear"</span>
</p>
<p class="pardesc"><span class="parcat">List of values:
      </span><span data-if="hdevelop" style="display:inline">'bilinear'</span><span data-if="c" style="display:none">"bilinear"</span><span data-if="cpp" style="display:none">"bilinear"</span><span data-if="com" style="display:none">"bilinear"</span><span data-if="dotnet" style="display:none">"bilinear"</span><span data-if="python" style="display:none">"bilinear"</span>, <span data-if="hdevelop" style="display:inline">'coord_map_sub_pix'</span><span data-if="c" style="display:none">"coord_map_sub_pix"</span><span data-if="cpp" style="display:none">"coord_map_sub_pix"</span><span data-if="com" style="display:none">"coord_map_sub_pix"</span><span data-if="dotnet" style="display:none">"coord_map_sub_pix"</span><span data-if="python" style="display:none">"coord_map_sub_pix"</span></p>
</div>
<h2 id="sec_result">结果</h2>
<p><code><span data-if="hdevelop" style="display:inline">gen_arbitrary_distortion_map</span><span data-if="c" style="display:none">gen_arbitrary_distortion_map</span><span data-if="cpp" style="display:none">GenArbitraryDistortionMap</span><span data-if="com" style="display:none">GenArbitraryDistortionMap</span><span data-if="dotnet" style="display:none">GenArbitraryDistortionMap</span><span data-if="python" style="display:none">gen_arbitrary_distortion_map</span></code> returns <TT>2</TT> (
      <TT>H_MSG_TRUE</TT>)
     if all parameter values
are correct. 如有必要，将引发异常。</p>
<h2 id="sec_successors">可能的后置算子</h2>
<p>
<code><a href="map_image.html"><span data-if="hdevelop" style="display:inline">map_image</span><span data-if="c" style="display:none">map_image</span><span data-if="cpp" style="display:none">MapImage</span><span data-if="com" style="display:none">MapImage</span><span data-if="dotnet" style="display:none">MapImage</span><span data-if="python" style="display:none">map_image</span></a></code>
</p>
<h2 id="sec_see">参考其它</h2>
<p>
<code><a href="create_rectification_grid.html"><span data-if="hdevelop" style="display:inline">create_rectification_grid</span><span data-if="c" style="display:none">create_rectification_grid</span><span data-if="cpp" style="display:none">CreateRectificationGrid</span><span data-if="com" style="display:none">CreateRectificationGrid</span><span data-if="dotnet" style="display:none">CreateRectificationGrid</span><span data-if="python" style="display:none">create_rectification_grid</span></a></code>, 
<code><a href="find_rectification_grid.html"><span data-if="hdevelop" style="display:inline">find_rectification_grid</span><span data-if="c" style="display:none">find_rectification_grid</span><span data-if="cpp" style="display:none">FindRectificationGrid</span><span data-if="com" style="display:none">FindRectificationGrid</span><span data-if="dotnet" style="display:none">FindRectificationGrid</span><span data-if="python" style="display:none">find_rectification_grid</span></a></code>, 
<code><a href="connect_grid_points.html"><span data-if="hdevelop" style="display:inline">connect_grid_points</span><span data-if="c" style="display:none">connect_grid_points</span><span data-if="cpp" style="display:none">ConnectGridPoints</span><span data-if="com" style="display:none">ConnectGridPoints</span><span data-if="dotnet" style="display:none">ConnectGridPoints</span><span data-if="python" style="display:none">connect_grid_points</span></a></code>, 
<code><a href="gen_grid_rectification_map.html"><span data-if="hdevelop" style="display:inline">gen_grid_rectification_map</span><span data-if="c" style="display:none">gen_grid_rectification_map</span><span data-if="cpp" style="display:none">GenGridRectificationMap</span><span data-if="com" style="display:none">GenGridRectificationMap</span><span data-if="dotnet" style="display:none">GenGridRectificationMap</span><span data-if="python" style="display:none">gen_grid_rectification_map</span></a></code>
</p>
<h2 id="sec_module">模块</h2>
<p>
Calibration</p>
<!--OP_REF_FOOTER_START-->
<hr>
<div class="indexlink">
<a href="index_classes.html"><span data-if="dotnet" style="display:none;">类别</span><span data-if="cpp" style="display:none;">类别</span></a><span data-if="dotnet" style="display:none;"> | </span><span data-if="cpp" style="display:none;"> | </span><a href="index_by_name.html">算子列表</a>
</div>
<div class="footer">
<div class="copyright">HALCON算子参考手册 Copyright © 2015-2023 51Halcon</div>
</div>
</div>
</body>
</html>
